home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / standard / ldclose.z / ldclose
Encoding:
Text File  |  1998-10-30  |  3.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4. LLLLDDDDCCCCLLLLOOOOSSSSEEEE((((3333XXXX))))                                                        LLLLDDDDCCCCLLLLOOOOSSSSEEEE((((3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ldclose, ldaclose - close a common object file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttddddiiiioooo....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ffffiiiilllleeeehhhhddddrrrr....hhhh>>>>
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyymmmmssss....hhhh>>>>
  15.      ####iiiinnnncccclllluuuuddddeeee <<<<llllddddffffccccnnnn....hhhh>>>>
  16.  
  17.  
  18.      iiiinnnntttt llllddddcccclllloooosssseeee ((((ldptr))))
  19.      LLLLDDDDFFFFIIIILLLLEEEE ****ldptr;;;;
  20.  
  21.      iiiinnnntttt llllddddaaaacccclllloooosssseeee ((((ldptr))))
  22.      LLLLDDDDFFFFIIIILLLLEEEE ****ldptr;;;;
  23.  
  24. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.      _l_d_o_p_e_n(3X) and _l_d_c_l_o_s_e provide uniform access to simple object files and
  26.      object files that are members of archive files.  An archive of common
  27.      object files can be processed as if it is a series of simple common
  28.      object files.
  29.  
  30.      If TTTTYYYYPPPPEEEE((((_l_d_p_t_r)))) does not represent an archive file, _l_d_c_l_o_s_e closes the
  31.      file and frees the memory allocated to the LLLLDDDDFFFFIIIILLLLEEEE structure associated
  32.      with _l_d_p_t_r.  If TTTTYYYYPPPPEEEE((((_l_d_p_t_r)))) is the magic number for an archive file and
  33.      if archive has more files, _l_d_c_l_o_s_e reinitializes OOOOFFFFFFFFSSSSEEEETTTT((((_l_d_p_t_r)))) to the
  34.      file address of the next archive member and returns FFFFAAAAIIIILLLLUUUURRRREEEE.  The LLLLDDDDFFFFIIIILLLLEEEE
  35.      structure is prepared for a later _l_d_o_p_e_n(3X).  In all other cases,
  36.      _l_d_c_l_o_s_e returns SSSSUUUUCCCCCCCCEEEESSSSSSSS.
  37.  
  38.      _l_d_a_c_l_o_s_e closes the file and frees the memory allocated to the LLLLDDDDFFFFIIIILLLLEEEE
  39.      structure associated with _l_d_p_t_r regardless of the value of TTTTYYYYPPPPEEEE(_l_d_p_t_r).
  40.      _l_d_a_c_l_o_s_e always returns SSSSUUUUCCCCCCCCEEEESSSSSSSS.  The function is often used with
  41.      _l_d_a_o_p_e_n.
  42.  
  43.      The program must be loaded with the object file access routine library
  44.      lllliiiibbbbmmmmlllldddd....aaaa.
  45.  
  46. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  47.      fclose(3S), ldopen(3X), ldfcn(4).
  48.  
  49. BBBBUUUUGGGGSSSS
  50.      OOOONNNNLLLLYYYY the memory associated with the LLLLDDDDFFFFIIIILLLLEEEE structure proper is freed.
  51.      Memory allocated for subordinate structures (e.g. the symbol table) must
  52.      be freed PPPPRRRRIIIIOOOORRRR to calling _l_d_c_l_o_s_e or _l_d_a_c_l_o_s_e.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.